home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / Utilities / Disk2File21 / DOCS.80 < prev    next >
Encoding:
Text File  |  1995-08-27  |  5.1 KB  |  138 lines  |  [TEXT/pdos]
  1.  
  2. DSK2FILE, version 2.1
  3.  
  4. Ronald T. Kneusel, August 1995. FREEWARE
  5. (rkneusel@post.its.mcw.edu)
  6.  
  7.  
  8. What is it?
  9. -----------
  10. DSK2FILE creates disk images of 5.25" disks (DOS 3.3 or ProDOS) for use with
  11. Apple ][ emulator programs.
  12.  
  13. DSK2FILE will create images in DOS 3.3 order (.DSK) or in ProDOS order (.PO)
  14. It does not matter what format the disk really is, you can use either order.
  15. Most emulators will handle DOS 3.3 order, some will also handle ProDOS order.
  16.  
  17.  
  18. What do I need to run it?
  19. -------------------------
  20.  
  21. You need a 5.25" drive and one of the following:
  22.  
  23. (1) a 3.5" drive
  24. (2) a hard drive
  25. (3) a RAM card with 150K or more
  26.  
  27. DSK2FILE will create the file, it is up to you to get the file to the PC or
  28. Mac.  See below for suggestions on how to do this.
  29.  
  30.  
  31. Running DSK2FILE
  32. ----------------
  33.  
  34. DSK2FILE's menu has two choices:
  35.  
  36. (1) 140K DISK -> IMAGE FILE
  37. (2) IMAGE FILE -> 140K DISK
  38.  
  39. You will likely use (1) the most often.  The second option is for those who
  40. might come across an image file and want to put that file back onto a disk
  41. and run it on a real Apple ][.
  42.  
  43. (1) 140K -> IMAGE FILE
  44.  
  45. DSK2FILE reads only 5.25" disks from slot 6, drive 1.  The program will ask
  46. for an image order, either DOS 3.3 or ProDOS and then ask for an output
  47. filename.  The appropriate extension is added to the filename.  Specify the
  48. *complete* pathname of the file, i.e. /RAM5/KARATEKA not just KARATEKA.
  49.  
  50. Insert the disk when asked and press return.  The image file will be created.
  51.  
  52.  
  53. (2) IMAGE FILE -> 140K DISK
  54.  
  55. Insert a *formatted* 5.25" disk in slot 6, drive 1 and specify the *complete*
  56. pathname of the image file as above.  The extension is important.  DSK2FILE
  57. uses it to determine what order the image file was written in.  If the image
  58. didn't have an extension change its name to have .DSK as the extension.  If
  59. it doesn't work, change it to .PO and try again.
  60.  
  61.  
  62. What's with the DOS and ProDOS orders?
  63. --------------------------------------
  64.  
  65. The Apple ][ has two different disk operating systems: DOS 3.3 and ProDOS.
  66. (Yes, there are several others, I'm simplifying a bit, I know :)
  67.  
  68. DOS 3.3 is the older and slower of the two and deals in 256 byte sectors with
  69. 16 sectors per track and 35 tracks per 5.25" disk.  ProDOS is faster and deals
  70. with 512 byte blocks, 280 per 5.25" disk.  Therefore, each ProDOS block 
  71. corresponds to two sectors.  However, these are not necessarily contiguous
  72. sectors.  ProDOS uses a different physical spacing of what DOS 3.3 would call
  73. sectors so that reading all the blocks from 0 to 279 in order writes the data
  74. on the disk to the file in one order while using track 0 to 34 and sector 0
  75. to 15 for each track will write the data in a different order.  Either way,
  76. all the data will be written, 143360 bytes total.
  77.  
  78.  
  79. How does it work?
  80. -----------------
  81.  
  82. Glad you asked! :)
  83.  
  84. DSK2FILE must run under ProDOS because it uses ProDOS MLI commands to handle
  85. the disk files.  This relieves the user from caring about the file type of
  86. the image file.  It also makes it much easier than using old DOS 3.3 RWTS
  87. calls.
  88.  
  89. The disk is read, block by block, and written to the output file in 512 byte
  90. sections.  If the output is to be in DOS 3.3 order a map is applied to the 
  91. block number to translate it into a track and sector with the appropriate
  92. 256 byte section of the block being written.  This is the easy part.
  93.  
  94. Writing an image to a disk is just as easy if the image is in ProDOS order.
  95. Read 512 bytes from the file and write it to block 0 and so on.  If it is a
  96. DOS 3.3 order image file life gets a bit tricky since we can only read and
  97. write 512 byte blocks but we are working with half a block at a time.  The 
  98. solution is to read the existing block, then read the 256 bytes from the image
  99. file and put it in the right half of the block buffer.  Then write the entire
  100. block back to disk.  This is why going from a DOS 3.3 image file to a disk 
  101. takes longer.
  102.  
  103.  
  104. What do I do with the image file?
  105. ---------------------------------
  106.  
  107. The end goal, of course, is to get the file to a PC or Macintosh (or Unix box)
  108.  
  109. I use a terminal program to upload the image file (written to my RAM card) to
  110. a Unix box and then download it to the Mac or PC. (Really, I FTP it since I
  111. have Internet access)  Another option is to use a null modem cable and go
  112. directly to a PC or Mac with the image file.  Lastly, you could write the file
  113. to a 3.5" ProDOS disk and use a Mac to read the file with Apple File Exchange.
  114. Then you could write the file to a PC disk if need be.
  115.  
  116.  
  117. It doesn't work, now what?
  118. --------------------------
  119.  
  120. Contact me at the email address above.  If you start seeing two digit hex
  121. numbers please write them down to help me in the debuging.  These are ProDOS
  122. MLI error codes.  DSK2FILE will not read copy protected disks.  Disks with
  123. bad blocks or sectors will still be written to an image file with nonsense
  124. in the bad block or sector. (Actually, it will be the data that was in the last block or sector successfully read)
  125.  
  126.  
  127. I'm in the dark ages and don't have email, how to I contact you?
  128. ----------------------------------------------------------------
  129.  
  130. If you feel a compelling need you can try snail mail:
  131.  
  132. Ron Kneusel
  133. 8725 W Burdick Ave
  134. Milwaukee, WI 53227 USA
  135.  
  136. AMDG
  137.  
  138.